home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / NEWSOFT / AUGUST / FREENET2 / !FreeNet / Docs / SLIPdriver < prev    next >
Text File  |  1996-10-13  |  6KB  |  131 lines
  1.                                SLIPdriver
  2.  
  3.                           (C) Tom Hughes 1995
  4.  
  5. 0. Copyright
  6.  
  7.   The SLIPdriver module described by this document and this document
  8.   itself are copyright (C) Tom Hughes 1995. They are however released as
  9.   freeware subject to certain terms and conditions. These are described
  10.   in the file named 'Licence' which should have accompanied this
  11.   document.
  12.  
  13.   Portions of the SLIPdriver module are taken from BSD source code, and
  14.   are subject to the BSD licence conditions given in the file named 'BSD'
  15.   which accompanies this document.
  16.  
  17. 1. Introduction
  18.  
  19.   This file describes the SLIPdriver module supplied with the FreeNet
  20.   TCP/IP stack. This module implements a hardware driver conforming to
  21.   version four of the Acorn DCI specification for hardware drivers and
  22.   provides hardware interfaces which talk the SLIP protocol over serial
  23.   lines.
  24.  
  25.   The driver supports an unlimited number of interfaces, each of which
  26.   is attached to a specified serial line. The serial lines are driven
  27.   using the blockdrivers, thus providing support for various dual serial
  28.   cards as well as the internal serial port.
  29.  
  30.   The module provides three commands, plus a number of SWIs and service
  31.   calls for implementing the DCI protocol. It can be loaded before or
  32.   after loading the TCP/IP stack it is going to work with, but the
  33.   interfaces you intend to use must be configured using the slattach
  34.   command before you can configure them into the TCP/IP stack using
  35.   ifconfig.
  36.  
  37. 2. The Serial Blockdrivers
  38.  
  39.   The SLIPdriver module uses the serial blockdrivers written by Hugo
  40.   Fiennes to talk to whatever serial interfaces you may have. These
  41.   reside in an application named !SerialDev which will need to have been
  42.   seen by the filer before attempting to use the SLIPdriver module.
  43.  
  44.   These blockdrivers should be available from ftp.demon.co.uk in the
  45.   directory /pub/archimedes. They are also available from most major
  46.   Acorn bulletin boards and FTP sites.
  47.  
  48.   If you intend to use the 'Internal' or 'InternalPC' drivers (used to
  49.   drive the built in serial port), you will need to be using at least
  50.   revision 11 of the blockdrivers, as there is a bug in earlier releases
  51.   that prevents these drivers working correctly with SLIPdriver.
  52.  
  53. 3. Configuring SLIP interfaces
  54.  
  55.   In order to use SLIP interfaces, you will need to load the SLIPdriver
  56.   module using RMRun, and this is usually done in the FreeNet startup
  57.   script. 
  58.  
  59.   Once the module has been loaded, the SLIP interfaces you wish to use
  60.   will need to be configured using the slattach command, the syntax of
  61.   which is as follows:
  62.  
  63.       slattach [{+|-}{c|e|f|m mtu}] <driver> <port> <speed>
  64.  
  65.   Where <driver> is the name of a blockdriver, <port> is the port number
  66.   for that driver, and <speed> is the speed at which you wish to run the
  67.   connection. Obviously, because this command needs to be able to load a
  68.   blockdriver, the !SerialDev application will need to have been seen by
  69.   the filer beforehand.
  70.  
  71.   If the serial port has already been set to the correct speed (perhaps
  72.   by a dialer application), the SLIPdriver can be told not to try and
  73.   set the speed by specifiying a speed of zero to the slattach command.
  74.  
  75.   As an example, the following line configures the internal serial port
  76.   for use with the SLIP driver, running at 19200 baud:
  77.  
  78.       slattach internal 0 19200
  79.  
  80.   Equally, the following configures two interfaces using the two ports
  81.   on a Serial Port dual serial card, each running at 38400 baud, with
  82.   one using a PC cable and one an Acorn cable:
  83.  
  84.       slattach sp_dual 0 38400
  85.       slattach sp_dualpc 1 38400
  86.  
  87.   Each configured port number, starting with zero, and the resulting
  88.   interfaces are named sl<n>. The numbers are assigned in order, starting
  89.   from zero, so the first interface to be configured will be sl0, the next
  90.   sl1 and so on.
  91.  
  92.   The MTU for an interface can be set using the -m switch. This takes
  93.   a numeric argument, which specifies the MTU for the interface. This
  94.   is the maximum size of packet which the interface can handle. If not
  95.   specified, it defaults to 576 bytes.
  96.  
  97.   There are also three switches, each of which can be used as a positive
  98.   switch (to turn something on) or a negative switch (to turn something
  99.   off). The first of these, the 'c' switch controls header compression,
  100.   so use +c to use CSLIP on that port.
  101.  
  102.   The second switch, 'e' controls auto-detection of header compression
  103.   when used by the remote host, and will cause CSLIP to be used if the
  104.   other host uses it. Note that only one host of the two connected hosts
  105.   can use this, so the server normally uses this, and the client uses
  106.   either +c or -c to control whether SLIP or CSLIP is used.
  107.  
  108.   Finally, the 'f' switch controls whether hardware flow control is used
  109.   or not. This, like the two previous switches, defaults to off.
  110.  
  111. 4. Removing SLIP interfaces
  112.  
  113.   A SLIP interface can be removed using the sldetach command. This
  114.   takes a single argument, which is the number of the interface you
  115.   wish to remove. Once an interface is removed, that number becomes
  116.   free, and slattach will reuse it when it is next used.
  117.  
  118. 5. Checking the modules status
  119.  
  120.   A third command is provided to check on the current status of the
  121.   SLIP driver, including what interfaces are configured, whether they
  122.   are currently active, and how much data has flowed through them. This
  123.   command is slstat, and takes no parameters.
  124.  
  125. 6. Closing the SLIP connections
  126.  
  127.   Killing the module will cause the TCP/IP stack to be informed that the
  128.   configured interfaces are no longer available, after which each of the
  129.   serial lines will be dropped, hence informing the remote system that
  130.   the link is being dropped.
  131.